home *** CD-ROM | disk | FTP | other *** search
/ The Epic Collection / Epic Collection, The (Epic Marketing)(1996).iso / lsdtools / lsd120.dms / lsd120.adf / docs / Z-CONVER.DOC.pp / Z-CONVER.DOC
Text File  |  1990-09-13  |  7KB  |  179 lines
  1.  
  2.  
  3.                              Z-Converter V1.0
  4.  
  5.                                 User Manual
  6.  
  7.                  Copyright © 1993 Grégoire Jean-Christophe
  8.                             All rights reserved
  9.                          Release Date: 12 June 1993
  10.  
  11.                                   FREEWARE
  12.  
  13.                          * * OUTLAWS PRODUCTION * *
  14.  
  15.  
  16.  
  17.  
  18.  
  19. 1] Copyright - Disclaimer
  20. =========================
  21.  
  22.   This program is distributed in the hope that it will be useful, but
  23. without any warranty, without even the implied warranty of merchantability
  24. or fitness for a particular purpose.
  25.  
  26.   Z-Converter is freeware. You may distribute it without any problem as
  27. long as you don't earn money with it.
  28.  
  29.   This doc MUST be distributed with the executable Z-Converter. Z-Converter
  30. is an utility provided to complete the Z-List package and should be
  31. distributed only with Z-List since only Z-List users might need it. Refer
  32. to the Z-List documentation for more about Z-List.
  33.  
  34.   The executable and non-executable parts of this software package may NOT
  35. be altered by any means (this includes editing, reprogramming, and
  36. resourceing), except archiving and crunching. The author is in no way
  37. liable for any changes made to any part of the package, or consequences
  38. thereof as he is in no way liable for damages or loss of data  directly
  39. or indirectly caused by this software.
  40.  
  41.   The Z-List package is copyright © 1993 by GREGOIRE Jean-Christophe.
  42.  
  43.             GREGOIRE Jean-Christophe,
  44.             64 Frans Timmermansstraat,
  45.             B-1600 Sint Pieters Leeuw,
  46.             BELGIUM.
  47.  
  48.   Z-Converter requires the ReqTools library which is copyright © Nico
  49. François. The library MUST be present on the disk used to spread
  50. Z-Converter.
  51.  
  52.  
  53. 2] Some Technical Thoughts
  54. ==========================
  55.  
  56.   As Z-List, Z-Converter is fully coded in assembler. It was written in
  57. 30 seconds.
  58.  
  59.  
  60. 3] What is Z-Converter ?
  61. ========================
  62.  
  63.   Z-Converter will convert old Hypercat lists in the Z-List format. If you
  64. never used Hypercat or don't use Z-List, this program is not for you !
  65.  
  66.  
  67. 4] Why did I write Z-Converter ?!
  68. =================================
  69.  
  70.   Because me and my friends used Hypercat before Z-List !
  71.  
  72.  
  73. 5] The Package
  74. ==============
  75.  
  76.   The package includes the following files. If you don't have all this,
  77. write to me for the full package.
  78.  
  79.      Z-List .................................... The program
  80.      Z-List.info ............................... The icon
  81.      Z-List.Doc ................................ This document
  82.      Z-List.Doc.info ........................... Its icon
  83.      Z-Converter ............................... Hypercat List Converter
  84.      Z-Converter.info .......................... Its icon
  85.      Z-Converter.Doc ........................... Its document
  86.      Z-Converter.Doc.info ...................... The document's icon
  87.  
  88.   ... and the ReqTools Library V38 (not for Kick 1.3) which can be found in
  89. the Libs directory.
  90.  
  91.   The nice Z-Converter, Z-Converter.Doc, Z-List and Z-List.Doc icons were
  92. drawn by my friend Falco. Thanks !
  93.  
  94.  
  95. 6] Compatibility & Bugs
  96. =======================
  97.  
  98.   Z-Converter should only work under kickstart 2.x or 3.x. No special care
  99. has been taken for Z-Converter but everything seems to be OK !
  100.  
  101.  
  102. 7] The author - me !
  103. ====================
  104.  
  105.   There's not much to say. I am 21 years old and I am student in industrial
  106. informatic (computer science in good english I heard). Maybe one day I will
  107. be graduated as programmer-analyst specialised in electronic, robotic and
  108. artificial intelligence. Who knows ?
  109.  
  110.  
  111. 8] Using The ReqTools Requesters
  112. ================================
  113.  
  114.   Z-Converter uses ReqTools Requesters. I'm not going to explain how to use
  115. them, but here are some tricks & tips:
  116.  
  117.  - The words displayed in bold in some gadgets mean that this gadget will
  118.    be activated too if you press return. This is what people call a
  119.    "keyboard shortcut" !
  120.  - Other Requesters offer underlined characters in the gadgets. When you
  121.    press together the right Amiga key and the underlined letter, the
  122.    gadget is selected as if you had clicked on it. Return also selects
  123.    the appropriate option accordingly to the current status.
  124.  - Hopeless, the ReqTools Requesters take as mouse pointer the one used
  125.    by your system. I can't control this, sorry about that.
  126.  - Using the File Requester (Save & Load), you can also click on your right
  127.    mouse button to get the drives. Use arrow keys up and down to make
  128.    appear and/or move the selection bar. ENTER to select, or cancel if
  129.    nothing was selected.
  130.  - If you are running Z-List and get a requester saying "Please Insert
  131.    Volume ENV:", this is normal: ReqTools is just looking for its
  132.    preferences in this volume (which should be created and assigned in
  133.    any normal WorkBench 2.x startup-sequence). This will happen only once
  134.    if you don't reboot and launch Z-List several times. You have 2
  135.    possibilities: get rid of the requester ! or assign this volume in
  136.    the startup-sequence of the disk you are running from if you wanna get
  137.    rid of it for the rest of your life...
  138.  
  139.  
  140. 9] Getting Started
  141. ==================
  142.  
  143.   Z-Converter can be either started from your WorkBench or the CLI/SHELL.
  144. In WorkBench, simply click on its icon. In CLI, simply type its name (which
  145. should normally be "Z-List"). No parameters are needed.
  146.  
  147.   Don't be surprised, Z-Converter first appropriates the CPU, yes ALL the
  148. CPU. This is because I think Z-Converter will be faster if you don't run
  149. several programs at the same time...
  150.  
  151.   Z-Converter is a very simple program and is not intended to be the best
  152. program ever made. It is a SERVICE and it hadn't to take me too much time.
  153. Therefore, please do what you should do and not forbidden things
  154. Z-Converter is not intended to deal with (load anything else than a
  155. Hypercat file for example...). I'm NOT responsible in any way for your
  156. strange ideas. Z-Converter doesn't try to validate the file you choose,
  157. however that could be done quite easily, but I have no time for this (very
  158. few people will need this program). The instructions follow...
  159.  
  160.   Once Z-Converter is loaded, you have a window with 3 gadgets. The first
  161. one (from left to right) calls a summary about how to use the program. The
  162. middle-gadget is simply 'Quit' and will cause the program to end. The last
  163. gadget calls a file requester.
  164.  
  165.   Once you have the file requester, simply choose a Hypercat list, then
  166. wait ! Hopeless, no progress indicator is displayed. That's not very
  167. important, the converter is anyway converting your list ! Once the job is
  168. done, you are back in the main window.
  169.  
  170.   Z-Converter will save the new formatted list in RAM: under the name
  171. 'Data.Z'. DON'T BE AFRAID for your old file, Z-Converter doesn't change a
  172. single byte in this file ! I chose this system because I wanted Z-Converter
  173. to be quickly done. If you want to convert several files, you'll have to
  174. first save the file 'Data.Z' in RAM: under a new name or save it elsewhere
  175. because it will be overwritten....
  176.  
  177.   That's all folks ! For any problem, you may always contact me.
  178.  
  179.